home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Tools / SFX-Player / Play16_1.8 / Play16.doc < prev    next >
Text File  |  2000-05-08  |  27KB  |  632 lines
  1.  
  2. ---------------------------------------------------------------------------
  3. -- Play16 version 1.8 (11.09.97) - a versatile soundplayer for the Amiga --
  4. ---------------------------------------------------------------------------
  5.  
  6. Readme.1st
  7. ----------
  8. Sorry folks, that's all I had time for. Comments still welcome :)
  9.  
  10. Features in brief
  11. -----------------
  12.  - FREEWARE!  No beta, no nag requesters and no expiry date!
  13.  - online help
  14.  - autodetects and plays several soundfiles, up to 16 bit / 56 kHz / stereo
  15.  - full Workbench support (but not Intuition and no GUI)
  16.  - always correct playback speed, even for sounds >28 kHz
  17.  - realtime playback from harddisk, optimized assembler routines
  18.  - optional 14 bit output (less noise but not as good as true 16 bit)
  19.  - Supports AHI and soundcards
  20.  - automatic or manual audio filter control
  21.  - plays mono sounds on *both* channels, not only on the left one
  22.  - plays (and loops) files that are larger than memory
  23.  - preloading for exactly timed start of playback
  24.  - fast µ-Law/A-Law decompression
  25.  - system friendly audio channel allocation
  26.  - optionally dump the output into a file (can be used to convert sounds)
  27.  - supported Filetypes are:
  28.  
  29.    * Microsoft RIFF-WAVE  (.WAV)  mono/stereo, 8/16 bit, linear/uLaw/ALaw/ADPCM
  30.    * Creative Voice File  (.VOC)  mono/stereo, 8/16 bit, linear
  31.    * Sun/NeXT Audio       (.AU)   mono/stereo, 8/16 bit, linear/uLaw
  32.    * MacroSystem Audio    (.MAUD) mono/stereo, 8/16 bit, linear/uLaw
  33.    * Apple/SGI/Amiga AIFF (.AIFF) mono/stereo, 8/16 bit, linear
  34.    * Amiga IFF-8SVX       (.IFF)  mono/stereo, 8    bit, linear/FibDelta/ExpDelta
  35.    * Any raw sound data as long as it matches one of the following:
  36.      -  8 bit signed
  37.      -  8 bit unsigned
  38.      - 16 bit signed, Intel format    (LSB first)
  39.      - 16 bit signed, Motorola format (MSB first)
  40.      - 14 bit µ-Law
  41.      - 14 bit A-Law
  42.  
  43.     - supported output devices are:
  44.  
  45.    * Native Amiga chipset (Paula)  8 bit
  46.    * Native Amiga chipset (Paula) 14 bit
  47.    * Native Amiga chipset (Paula) 14 bit calibrated (Christian Buchner)
  48.    * MacroSystem Maestro Pro      16 bit 44.1kHz and 48kHz only
  49.    * IFF-8SVX file dump            8 bit
  50.    * AHI audio system             16 bit
  51.    * Prelude                      16 bit
  52.  
  53. ========================== Section 1: Quick start =========================
  54.  
  55. What do I need to use Play16?
  56. -----------------------------
  57. Any Amiga running Kickstart/Workbench 2.04 or greater.
  58.  
  59. asyncio.library
  60.  
  61. To use the calibrated 14 bit output you need a valid CyberSound preferences
  62. file in your ENVARC: directory. If you don't have one already it can be
  63. generated with Christian's calibration package included in this distribution.
  64.  
  65. Maestix.library V39 or higher is required to use the MPro board for output.
  66.  
  67. AHI audio system V2 or higher is required to use AHI output.
  68.  
  69. Where do I find the latest version?
  70. -----------------------------------
  71.  - FIDONET: Amiga Venture BBS, Germany (2:2432/350)
  72.  - AMINET:  mus/play
  73.  - WWW:     http://linux.rz.fh-hannover.de/~wenzel/Play16/
  74.  
  75. further I recommend to have a look at the following packages:
  76.  
  77. Prelude:
  78.  - WWW:     http://linux.rz.fh-hannover.de/~wenzel/Prelude.html
  79.  
  80. CyberSound:
  81.  - AMINET:  disk/cdrom/14Bit_CDPlayer.lha
  82.  
  83. Maestix:
  84.  - AMINET:  util/libs/Maestix39_00.lha
  85.  
  86. AHI audio system:
  87.  - WWW:     http://www.lysator.liu.se/~lcs/ahi.html
  88.  
  89.  
  90. How do I use it?
  91. ----------------
  92. From CLI:       Simply type "Play16 <filename>" and that's it!
  93. From Workbench: Just doubleclick on it's icon. A filerequester will pop up.
  94.  
  95. All possible options will be explained later. If you set none of them, the
  96. defaults will be used.
  97.  
  98.  
  99.  
  100.  
  101. ==================== Section 2: Background information ====================
  102.  
  103. What does it do?
  104. ----------------
  105. Basically, Play16 is capable of playing uncompressed and _some_ compressed
  106. soundfiles through Amiga's standard audio device or an increasing number of
  107. alternative devices. If the actual resolution or playback rate exceeds that
  108. of the Amiga hardware, realtime conversion is done so that the sound is
  109. being played back correctly.
  110.  
  111. You can even play 16 bit / 44.1 kHz sounds on the old amiga chipset (Paula),
  112. providing all parts of your system can keep up with the high data transfer
  113. rate and lots of calculations needed for this task. (In this case an
  114. accelerated Amiga is recommended :-)
  115.  
  116. The two audio channels at each side can be linked to perform as a single
  117. 14 bit channel (subranging). Again, this swallows lots of computing power.
  118.  
  119. Anyway, an Amiga 3000-16MHz is fast enough to play an uncompressed soundfile
  120. with full 44.1kHz/14bit output (productivity) directly from harddisk !!!
  121.  
  122. I don't want Play16 to be a program that plays each and every exotic format
  123. that exists somewhere. However, I intend to support as many popular file
  124. types as possible.
  125.  
  126.  
  127. Why Play16?
  128. -----------
  129. I didn't find any CLI based program to play back 16 bit recordings, on a
  130. standard Amiga, so I decided to write one myself.
  131.  
  132.  
  133. Why CLI based and no GUI?
  134. -------------------------
  135. There are so many GUI based directory utilities, simply use Play16 as an
  136. external player. Consult the manual of your software package on how to
  137. do it. Application example: Assign "Play16 <filename> PRELOAD" to a button
  138. called "Jingle". Select the desired soundfile and press the Jingle-button.
  139. Wait for the appropriate moment and hit the return key - here comes the
  140. sound! Nice when audio dubbing your home videos or even on parties :-)
  141.  
  142.  
  143. How does it work? (technical info)
  144. ----------------------------------
  145. The standard Amiga audio device is limited to 8 bit / 28 kHz playbck
  146. when using DMA. With the introduction of ECS the 28 kHz DMA barrier
  147. was broken - but only if the current displaymode was one with double
  148. scan rate like productivity. The reason for this is the dependency
  149. between video and audio DMA. If you don't have ECS or if you simply
  150. don't want to switch to Productivity just to listen to your desired
  151. sound, Play16 can halve the sample rate during playback.
  152.  
  153. Another way to archieve high output rates is using IRQ. This works no
  154. matter what the displaymode is. I've been experimenting on that long
  155. before I started writing Play16 but there was so much jitter that my
  156. current downsampling method sounds much better.
  157.  
  158. To play back even long sounds, the popular method of double buffering
  159. is used. Alternatively, all data can be loaded into memory before
  160. playback. This is useful when playing short sounds or when loading
  161. the sound from floppy disk or slow network transfers.
  162.  
  163. The 14 bit output is archieved by setting the first channel on each
  164. side to volume 64 and the second to volume 1. The louder channel then
  165. plays the upper 8 bits as usual while the other channel plays the
  166. 6 most significant bits of the low byte synchronously. Because timing
  167. is very crucial in this case it is nessecary to write directly to
  168. hardware registers instead of using the audio.device. This method may
  169. not work on future amiga models if there ever will be any... :-/
  170.  
  171. Unfortunately, Amiga's DACs are not perfectly linear. A significant
  172. increase in sound quality can be archieved by calibrating each
  173. MSB conversion step individually for your machine. Christian Buchner's
  174. CyberSound system supports this kind of calibration. Play16 can load
  175. the preferences file generated by Christian's calibration program.
  176.  
  177. The MPro output uses the maestix.library by Richard Körber. Have a look
  178. at the Maestix package available on AMINET for further details.
  179.  
  180. =========================== Section 3: Options ============================
  181.  
  182. What options are provided?
  183. --------------------------
  184. There are three ways to specify the options, which are:
  185.  
  186.  CLI:       In the commandline, using standard AmigaOS 2.x template
  187.  Workbench: In the icon, using standard Amiga Workbench tooltype entries
  188.  General:   By setting environment variables. This is not possible for
  189.             all options yet.
  190.  
  191. If you are not familiar with the AmigaOS 2.x commandline template, see
  192. the examples below and consult the AmigaOS manual for furhter information.
  193. The tooltype entries are identical to the keywords you can specify in the
  194. commandline. Also, the environment variables have the same names and reside
  195. in ENV:Play16. 
  196.  
  197. Basic options: (All optio